home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / th53.zip / TH53.DOC < prev    next >
Text File  |  1991-08-16  |  17KB  |  426 lines
  1.  
  2.  ╒════════════════════════════════════════════════════════════════════════════╕
  3.  │                                                                            │
  4.  │   ░░░░░░░▄ ░░░░▄ ░▄     ░░░░▄          ░▄   ░▄  ░░░░░▄  ░░    ░▄  ░░░░░▄   │
  5.  │    ▀▀░█▀▀▀ ░█▀▀▀ ░█     ░█▀▀▀          ░█   ░█  ░█▀▀░█  ░█░   ░█  ░█▀▀▀▀   │
  6.  │      ░█    ░░░░▄ ░█     ░░░░▄   ░░░░▄  ░░░░░░█  ░░░░░█  ░██░  ░█  ░█ ░░▄   │
  7.  │      ░█    ░█▀▀▀ ░█     ░█▀▀▀    ▀▀▀▀  ░█▀▀▀░█  ░█▀▀░█  ░█ █░ ░█  ░█ ▀░█   │
  8.  │      ░█    ░░░░▄ ░░░░░▄ ░░░░▄          ░█   ░█  ░█  ░█  ░█  █░░█  ░░░░░█   │
  9.  │       ▀     ▀▀▀▀  ▀▀▀▀▀  ▀▀▀▀           ▀    ▀   ▀   ▀   ▀   ▀▀▀   ▀▀▀▀▀   │
  10.  │                                                                            │
  11.  ╘════════════════════════════════════════════════════════════════════════════╛
  12.   Version 5.3  Version 5.3  Version 5.3  Version 5.3  Version 5.3  Version 5.3
  13.  
  14.              DORINFOx.DEF; PCBOARD.SYS; LASTUSxx.DAT; DOOR.SYS;
  15.               SFDOORS.DAT; CHAIN.TXT; CALLINFO.BBS Compatible!
  16.  
  17.  
  18.              -─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-
  19.              -─-─-─-─-─ Copyright (c) 1991 David Terrian -─-─-─-─-
  20.              -─-─-─-─-─-─ SysOp of: The Room&Board BBS -─-─-─-─-─-
  21.              -─-─-─-─-─-─-─-─ 24 Hours * 3/12/2400 -─-─-─-─-─-─-─-
  22.              -─-─-─-─-─-─-─-─-─- (313) 659-1846 ─-─-─-─-─-─-─-─-─-
  23.              -─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-
  24.  
  25.  
  26.  
  27.  
  28.             The Important Version 5.3 Enhancements - Please READ
  29.         ------------------------------------------------------------
  30.  
  31.         -  Configurable IRQ lines for communication ports 1-4.
  32.  
  33.         -  SysOp configurable time limits definable for each puzzle.
  34.            Shell and chat time *given back* if initiated while user
  35.            is working on a puzzle (ie: time limit doesn't run out).
  36.  
  37.         -  SysOp can now define HOW MANY times a user can play
  38.            each puzzle each day.
  39.  
  40.         -  Tele-Hang now can create a file which contains a list
  41.            of the words which were not accepted by the spell 
  42.            checker.  This file is definable in the SETUP program.
  43.  
  44.         -  Tele-Hang ALSO can now create a file containing a list
  45.            of all puzzles entered, who entered them, and how many
  46.            times the puzzle was failed.  You may wish to post this 
  47.            as a bulletin or just view it for your own interests.
  48.            This file is definable in the SETUP program.  FYI, you
  49.            may change the header of this file once it is created.
  50.  
  51.  
  52.  
  53.         -  SysOp may also configure the minimum and maximum lengths
  54.            for each individual puzzle.  No longer does it have to
  55.            be the same for all of them.
  56.  
  57.         -  Now each puzzle may have its own Supplementary Word List.
  58.  
  59.         -  /LOCAL switch now available which defaults to SYSOP.
  60.  
  61.         -  Users activated for the month and given champ points
  62.            if they get points for puzzles they entered last month.
  63.  
  64.         -  When playing puzzle in which user is current champ,
  65.            Tele-Hang now shows them the puzzle and times failed.
  66.  
  67.         -  Many of the file I/O's have been sped up, including
  68.            the supplementary word list scheme and lots more.
  69.  
  70.         -  Much of the excess ANSI output has been eliminated
  71.            speeding up output.
  72.  
  73.         -  The Tele-Hang bulletin now shows the record puzzle,
  74.            who entered it, and how many times it was failed.
  75.  
  76.  
  77.  
  78.         -  As a user's time is running down while solving a puzzle,
  79.            the bottom of the gallow now slips away under their
  80.            feet until - when all time is up, they get hung.
  81.  
  82.         -  The C)atalog option enhanced; more info (try it!).
  83.  
  84.         -  Last month's champ now shown in scoreboard (not just
  85.            bulletin).
  86.  
  87.         -  Pause during unregistered logoff screen eliminated.
  88.  
  89.         -  Line showing letters guessed not erased immediately
  90.            upon failing puzzle (in case you write it down).
  91.  
  92.         -  Removed BBS software specific names.
  93.  
  94.         -  Removed ANSI from LOG file (smaller, quicker).
  95.  
  96.         -  User may elect to not play a puzzle after seeing puzzle
  97.            info (ie: topic, time allowed, etc, which are also new
  98.            to version 5.1).
  99.  
  100.  
  101.  
  102.  
  103.         -  Screen saves now not defaulting to BIOS... (oops)
  104.  
  105.         -  Corrected local mode not running on OPUS or Wildcat!.
  106.  
  107.         -  Corrected not being able to enter number 0 at the
  108.            play which puzzle prompt (found out from code, no
  109.            one reported this).
  110.  
  111.         -  On '7) Quit, Y/N?' prompt, TH now defaults to Y on return.
  112.  
  113.         -  The SETUP.EXE program has been rewritten and enhanced
  114.            to support the new features and more of the old ones.
  115.  
  116.         -  Adopt-A-DOOR is still available, but I want to remind
  117.            you how. Once Tele-Hang is registered simply create a
  118.            file called LIGHTS with the peoples names to be displayed,
  119.            each on a separate line in the file.
  120.  
  121.         -  Fixed a bug from version 5.1/2 which slowed down output.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                            The Necessary Disclaimer
  129.  
  130. ┌──────────────────────────────────────────────────────────────────────────────┐
  131. │                                                                              │
  132. │       This software is supplied "As Is".  Although it has been tested        │
  133. │     and believed safe if used correctly, I shall not have any liability      │
  134. │     for special, incidental, or consequential damages arising out of or      │
  135. │     resulting from the use of this program.  This software comes without     │
  136. │     any warranty, expressed or implied.  If you do not agree with this,      │
  137. │     please don't use this software.                                          │
  138. │                                                                              │
  139. └──────────────────────────────────────────────────────────────────────────────┘
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153. ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ Installation Info ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  154.  
  155.  
  156.         UPGRADING:
  157.  
  158.                    From version 5.0 5.1 and 5.2:
  159.  
  160.                      1) Replace TH.EXE    -> with TH53.EXE.
  161.                      2) Replace SETUP.EXE -> with SETUP53.EXE.
  162.                      3) Fix your batch file to run TH53.EXE not TH.EXE.
  163.                      4) Run SETUP53 and set everything the way you
  164.                         want it.
  165.  
  166.  
  167.                    From version 4.0:
  168.  
  169.                      Delete all of your v4.0 files and replace them
  170.                     with the files in this archive.  You will have
  171.                     to start over when upgrading from version 4.
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.         INSTALLING FOR THE FIRST TIME:
  179.  
  180.                    Unzip TH53.ZIP into its own dir/subdir as usual.
  181.                   Simply run SETUP53 to begin answering the necessary
  182.                   questions.  At the very least, you must edit the
  183.                   info in the Toggles and File Specs menues.
  184.  
  185.                   To execute SETUP53, the syntax is:
  186.  
  187.                   ┌────────────────────────────────────────────────┐
  188.                   │      SETUP53 <Config Filespec> {/S} {/BW}      │
  189.                   └────────────────────────────────────────────────┘
  190.  
  191.                      <Config Filespec> is the name of the file that
  192.                     will be created to hold the configuration info.
  193.                     Example: SETUP53 HANG.CFG
  194.  
  195.                      The optional /S and /BW suppress sound and
  196.                     or color (see TH syntax below for details).
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ Running The DOOR ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  204.  
  205.              Note: See example batch file included in this archive.
  206.  
  207.             ┌──────────────────────────────────────────────────────┐
  208.             │  TH53 <Config Filespec> {/TEST} {/S} {/BW} {/LOCAL}  │
  209.             └──────────────────────────────────────────────────────┘
  210.  
  211.              The parameters /TEST, /S, /BW and /LOCAL are optional and
  212.            can be specified together in any order, one at a time, or none.
  213.  
  214.  
  215.            /TEST  will cause Tele-Hang to create a file named OUT in the
  216.                    current directory showing the output shown to the user.
  217.                    Use this if you find a bug and want to report it to me.
  218.            /S     will cause Tele-Hang to supress the sounds that it makes
  219.                    in ANSI local mode.  It will have NO effect on the sound
  220.                    sent out the com port.
  221.            /BW    will cause Tele-Hang to run without color on the LOCAL
  222.                    side if you have a monochrome monitor.
  223.            /LOCAL will prevent the need for a door info file and default
  224.                    to: LOCAL user named SYSOP in ANSI mode.
  225.  
  226.  
  227.  
  228. ≡≡≡≡≡≡≡≡≡≡≡ SysOp Functions Available In TH ≡≡≡≡≡≡≡≡≡≡≡≡
  229.  
  230.  
  231.             F1 - - - - - - - - -> Help, shows this info on status
  232.                                   line. Disappears after 5 seconds.
  233.             F5 - - - - - - - - -> SysOp shell to DOS.
  234.             F8 - - - - - - - - -> Promptly return user to BBS
  235.                                   and cleanly saves user stats.
  236.             F10  - - - - - - - -> Chat Mode - ESCape exits.
  237.             Left Arrow - - - - -> Decrease time left by one minute.
  238.             Control Left Arrow -> Decrease time left by ten minutes.
  239.             Right Arrow  - - - -> Increase time left by one minute.
  240.             Control Right Arrow > Increase time left by ten minutes.
  241.  
  242.              Note: Time left only changes time in door, not on BBS.
  243.                    When in chat or DOS shell, the clock stops in the
  244.                    door.  Only when using PCBoard.SYS does it give time
  245.                    credit back to the BBS.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253. ≡≡≡≡≡≡≡≡≡≡≡≡ The Files That Tele-Hang Uses ≡≡≡≡≡≡≡≡≡≡≡≡≡
  254.  
  255.    NOTE: TH53.EXE and SETUP53.EXE use a fairly safe self virus checking scheme.
  256. ────────────────────────────────────────────────────────────────────────────────
  257.  * Files included in your Archive *
  258.  
  259.      TH53     . DOC  -  This documentation.
  260.      HANG     . REG  -  Information on how to register Tele-Hang.
  261.      BROWSE   . COM  -  Use to view TH.DOC. Type BROWSE TH.DOC.
  262.      TH53     . EXE  -  The Tele-Hang executable DOOR program.
  263.      SETUP53  . EXE  -  Utility for configuring and editing Tele-Hang.
  264.      HANG     .      -  Example batch file for invoking this DOOR.
  265.      TH-PD    . DIX  -  Demo dictionary file - 50K words.
  266. ────────────────────────────────────────────────────────────────────────────────
  267.  * Files created by Tele-Hang *
  268.  
  269.      HANG     . USR  -  Tele-Hang users file; Holds users and other info.
  270.      CHAMPx   .      -  File keeping track of the champion and puzzle info.
  271.      RECORD   .      -  File holding record setting puzzle.
  272.      TODAY    . USR  -  File created to keep track of who's played today.
  273.      PUZZLES  . LST  -  Log of all puzzles entered,by whom,times failed.
  274.      SPELL    . CHK  -  Lists words not accepted by the dictionary.
  275. ────────────────────────────────────────────────────────────────────────────────
  276.  
  277.  
  278. ≡≡≡≡≡≡≡≡≡≡≡≡ Dictionaries Available For TH ≡≡≡≡≡≡≡≡≡≡≡≡
  279.  
  280.  
  281.         Version 5.3 includes a small demo dictionary inside its archive
  282.       (50k words; 340,000 bytes). This dictionary, HANG.DIX, is large
  283.       but not large enough for most applications.  I *WILL* be creating
  284.       a directory on my BBS which will hold other dictionaries.  At this
  285.       time, I also *PLAN* on creating a combined (and huge) dictionary
  286.       which will only be usable on the registered version of Tele-Hang.
  287.       Large dictionaries (400,000+) will not function on version 5.1+
  288.       unless it has been registered.  Hope to create a new sheme that
  289.       shortens the dictionary file length while adding more words.
  290.  
  291.         The dictionary included with version 5.1 5.2 and 5.3 of Tele-Hang
  292.       will not work on version 5.0 and vice versa.  They contain the 
  293.       same words.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303. ≡≡≡≡≡≡≡≡≡≡≡≡ Supplementary Word List Info ≡≡≡≡≡≡≡≡≡≡≡≡≡
  304.  
  305.  
  306.         The Supplementary Dictionary word list is simply that - a list of 
  307.       words.  It is a straight text file with the words that you want to 
  308.       allow that the dictionary won't allow.  Note: The speed should be
  309.       much faster in v5.1+ compared to v5.0 although still not as fast
  310.       as the dictionary file.
  311.  
  312.         Version 5.3 of Tele-Hang allows both a COMMON word list as well
  313.       as individual lists for each puzzle.  Hopefully this will expand
  314.       to individual dictionaries as well in a later version.  The name
  315.       of the common list file is something you set in the SETUP53 File
  316.       Specs menu;  use the Puzzle Maint menu to edit the individual puzzle
  317.       word lists (under Sup:).  The words do not have to be in caps or any
  318.       alphabetic order. The supplementary dictionary is not designed to be
  319.       as fast as the .DIX file, and is just for small additions.  If you 
  320.       get a large word list going, upload or mail it to me, and I will add 
  321.       it to the faster DIX dictionary file(s).
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. ≡≡≡≡≡≡≡≡≡≡≡≡≡ Commonly Asked Questions ≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  329.  
  330.  
  331.         "I am using a high speed modem, and Tele-Hang won't work.  Why?"
  332.            - Go to the Locked Baud Rate option in SETUP53.  Set it to the
  333.              locked rate of your modem (ie: 9600, 19200, 38400, etc)
  334.  
  335.         "How do I set the topics so that they aren't always 'General'?"
  336.            - With the PUZZLE MAINTENANCE menu in the SETUP53 program.
  337.  
  338.         "What causes the msg 'Only com 0-4 supported' when executing TH53?"
  339.            - Your BBS type is not supported or you have given the wrong
  340.              file spec for your door info file.  Possibly try to use a 
  341.              converter to make a DOORINFOx.DEF or PCBOARD.SYS file.  
  342.              Please let me know if this happens!
  343.  
  344.         "Why do my puzzles sometimes say they are locked?"
  345.            - A puzzle is locked whenever a user plays it, however it should
  346.              be UN-locked whenever they leave the puzzle and/or DOOR.  You
  347.              may have had a fatal error such as not enough memory, or
  348.              insufficient disk space and it caused TH not to exit cleanly.
  349.              All known causes of this have been corrected in v5.1.
  350.  
  351.  
  352.  
  353. ≡≡≡≡≡≡≡≡≡≡≡≡≡ Registration Information ≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  354.  
  355.  
  356.         Tele-Hang v5.3 is distributed in its Unregistered form.  It is
  357.       fully functional, therefore I don't consider it "Crippleware".  The
  358.       registered version does, however, offer certain advantages.  If
  359.       you find this DOOR enjoyable, you will want to consider upgrading
  360.       to the registered version.
  361.   
  362.         For twenty-five dollars you will be able to turn your program
  363.       into the registered version.  I can either mail you a disk or allow
  364.       you to download a simple 600 byte text file from my BBS.  For
  365.       information about registering, please see the file name HANG.REG
  366.       included in the archive.
  367.  
  368.       Listed below are some of the enhancements you will receive:
  369.  
  370.         . A configurable number of active puzzles (up to 25).
  371.         . SysOp defined maximum puzzle lengths (up to 43 characters) as
  372.           well as individual topics, time limits, plays on each puzzle.
  373.         . You will also be allowed to download the latest versions
  374.           anytime off of my BBS with no upgrade fee!
  375.  
  376.  
  377.  
  378. ≡≡≡≡≡≡≡≡≡≡≡≡≡ Registration Information ≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  379.  
  380.  
  381.         With the release of Tele-Hang version 5.1, the registration fee
  382.       has increased from $20 to $25.  For those who have registered
  383.       prior to this new release, there will be no upgrade fee (ie: the
  384.       registration is good for version 5.1+ as well as version 5.0).  For
  385.       those sending in $20 after this release, a registration for version
  386.       5.0 (only) will be sent until an addition $5 (for download) or $7
  387.       for shipping is received at which time a version 5.3+ registration
  388.       will be made.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403. ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ Closing ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡
  404.  
  405.  
  406.                           That's all there is to it...
  407.  
  408.         I hope you find this enjoyable, and well worth registering.
  409.       See file named HANG.REG. Comments or questions? Call or write!
  410.       I also try to scan the FIDO and RIME door conferences for mail.
  411.  
  412.  
  413.         Lastly, let me take a line or two to send out my appreciation
  414.       to all who have registered and encouraged the creation of this
  415.       program.  I thank each and every one of you.
  416.  
  417.  
  418.                  The Room&Board BBS             P.O. Box 264
  419.                  2400 Baud/24 Hours          Flushing, MI 48433
  420.                    (313) 659-1846
  421.  
  422.                                                            Thank-you,
  423.                                                          [Dave Terrian]
  424.  
  425. (Eof)
  426.